Admin Panel

Manage products, categories, orders, and inventory as an administrator in Iquea Commerce

Overview

Administrators have elevated permissions to manage the entire Iquea Commerce platform. This guide covers admin-specific features for product management, category organization, order processing, and inventory control.

Admin features are only accessible to users with role ADMIN. Regular customers with role CLIENTE do not have access to these functions.

Admin Authentication

Admin users authenticate through the same login system but have elevated privileges:

User Roles

Role	Description	Permissions
CLIENTE	Regular customer	Browse, purchase, view own orders
ADMIN	Administrator	Full CRUD on products, categories, view all orders

Admin status is determined by the rol field in the user account. This is set at the database level and cannot be self-assigned.

Managing Products

Administrators have full control over the product catalog through dedicated endpoints.

Viewing All Products

1. Access Product List

   Navigate to the admin product management section

2. View Product Grid

   All products are displayed with:

   • Product ID and SKU
   • Name and description
   • Category assignment
   • Price (amount and currency)
   • Dimensions (height × width × depth)
   • Featured status (es_destacado)
   • Current stock level
   • Product image
3. Filter and Search

   Use admin filters to find products:

   • Search by name
   • Filter by category
   • Filter by price range
   • Filter by SKU
   • Show only featured products

Creating New Products

Add new items to the product catalog:

1. Open Create Product Form

   Click “Add New Product” or “Crear Producto”

2. Fill Required Fields

   Complete all required product information:

   Basic Information

   • SKU: Unique stock keeping unit code
   • Name (nombre): Product name
   • Description (descripcion): Detailed product description

   Pricing

   • Price Amount (precioCantidad): Numeric price value
   • Currency (precioMoneda): Currency symbol (e.g., ”€”)

   Dimensions

   • Height (dimensionesAlto): Height in cm
   • Width (dimensionesAncho): Width in cm
   • Depth (dimensionesProfundo): Depth in cm

   Inventory

   • Stock: Number of units available
   • Featured (es_destacado): Mark as featured product

   Media

   • Image URL (imagen_url): Product image URL

   Categorization

   • Category: Select product category
3. Submit Product

   Click “Create” to submit:

   • POST request to /api/productos
   • Product is validated and saved
   • Returns created product with assigned ID
4. Verify Creation

   New product appears in product list and is immediately available to customers

The SKU must be unique across all products. Duplicate SKUs will cause creation to fail.

Updating Products

Modify existing product information:

1. Select Product to Edit

   Click “Edit” on any product in the admin product list

2. Modify Fields

   Update any product fields:

   • Change price
   • Update stock levels
   • Toggle featured status
   • Modify description
   • Update dimensions
   • Change category
   • Update image URL
3. Save Changes

   Click “Update” or “Save”:

   • PUT request to /api/productos/sku/{sku}
   • Product is validated and updated
   • Changes are immediately reflected

Updating product prices does NOT affect existing orders. Orders lock prices at the time of purchase.

Deleting Products

Remove products from the catalog:

1. Select Product

   Find the product you want to delete

2. Click Delete

   Click “Delete” or trash icon button

3. Confirm Deletion

   Confirm the deletion action in the dialog:

   • DELETE request to /api/productos/{id}
   • Product is permanently removed
4. Verify Removal

   Product no longer appears in catalog or search results

Deleting products may affect existing orders that reference them. Consider marking products as out of stock instead of deletion.

Managing Categories

Organize products into logical categories for better navigation.

Viewing All Categories

Access the category management interface:

• View list of all categories
• See category name and slug
• Check number of products per category

Creating Categories

1. Open Create Category Form

   Click “Add Category” or “Nueva Categoría”

2. Enter Category Details

   Fill in:

   • Name (nombre): Display name (e.g., “Salón”, “Dormitorio”)
   • Slug: URL-friendly identifier (e.g., “salon”, “dormitorio”)
3. Submit Category

   Click “Create”:

   • POST request to /api/categorias
   • Category is created and available for product assignment

Updating Categories

Modify existing category information:

1. Select Category

   Click “Edit” on a category

2. Update Fields

   Change name or slug

3. Save Changes

   Submit update:

   • PUT request to /api/categorias/{nombre}
   • Category is updated
   • All products in category reflect new name

Deleting Categories

1. Select Category

   Choose category to delete

2. Delete Category

   Click delete:

   • DELETE request to /api/categorias/{nombre}
   • Category is removed

Deleting a category may leave products without category assignment. Reassign products before deleting categories.

Viewing All Orders

Administrators can view and manage all customer orders.

Order Management Interface

1. Access Order Dashboard

   Navigate to “Orders” or “Pedidos” in the admin panel

2. View All Orders

   Unlike customers who see only their orders, admins see:

   • All orders from all customers
   • Order reference codes
   • Customer information
   • Order dates
   • Current status
   • Order totals
3. Filter Orders

   Use filters to find specific orders:

   • By Status: GET /api/pedidos/estado/{estado}
   • By Customer: Filter by user ID
   • By Date: Filter by creation date range
   • By Reference: Search by reference code

Updating Order Status

Admins can manually change order status:

1. Select Order

   Click on an order to view details

2. Change Status

   Select new status from dropdown or buttons:

   • PENDIENTE → CONFIRMADO
   • CONFIRMADO → ENVIADO
   • ENVIADO → ENTREGADO
   • Any status → CANCELADO
3. Save Status Change

   Submit update:

   • PUT request to /api/pedidos/{id}
   • Order status is updated
   • Customer sees new status

Viewing Order Details

Admins have full access to all order information:

• Complete customer information
• All line items with products
• Pricing details (unit price, quantity, subtotals)
• Order history and status changes
• Shipping information

Modifying Orders

Admins can update order details:

1. Open Order Editor

   Select order and click edit

2. Modify Order Details

   Make changes:

   • Add items: POST /api/pedidos/{id}/detalles
   • Remove items: DELETE /api/detalles/{id}
   • Update quantities: PUT /api/detalles/{id}/cantidad?cantidad={qty}
3. Recalculate Total

   Order total updates automatically based on detail changes

Modifying orders after confirmation may confuse customers. Consider cancelling and creating a new order instead.

Deleting Orders

Admins can permanently delete orders:

• Click delete on order
• Confirm deletion
• DELETE request to /api/pedidos/{id}
• Order and all details are removed

Deletion is permanent and cannot be undone. Use cancellation status instead when possible.

Inventory Management

Control product stock levels and availability.

Updating Stock Levels

1. Navigate to Product

   Find product in admin product list

2. Edit Stock Field

   Update the stock field with new inventory count

3. Save Changes

   Submit product update:

   • Stock level is updated immediately
   • Products with stock = 0 show as “Agotado” to customers

Stock Visibility

• Stock > 0: Product available for purchase, shows “X unidades”
• Stock = 0: Product shows as “Agotado”, cannot be added to cart

Bulk Stock Updates

For updating multiple products:

1. Use product filters to find items needing updates
2. Update each product individually via API
3. Consider batch import/export for large inventory changes

The platform does not currently have automated stock deduction on order placement. Admins must manually adjust inventory after processing orders.

Product Search and Filtering

Admins have access to advanced search endpoints:

Available Search Methods

Endpoint	Description	Example
/api/productos/buscar?nombre={text}	Search by name	nombre=sofá
/api/productos/precio?min={min}&max={max}	Filter by price range	min=100&max=1000
/api/productos/sku/{sku}	Find by SKU	sku=SOFA-001
/api/productos/destacados	Get featured products	-
/api/productos/categoria/{id}	Filter by category	categoria/5

Admin Best Practices

Verify Before Deletion

Always verify that products/categories are not actively referenced before deletion. Check for existing orders.

Maintain Stock Accuracy

Regularly update stock levels to reflect actual inventory. Set stock to 0 for unavailable items rather than deleting.

Use Featured Products Strategically

Mark high-quality or promotional items as featured. Limit to 6-8 products for optimal homepage display.

Process Orders Promptly

Update order statuses in a timely manner so customers can track their purchases accurately.

Maintain Category Structure

Keep category names consistent and logical. Use singular or plural consistently across all categories.

Security Considerations

Role-Based Access

Admin functions are protected:

• Backend validates user role before allowing admin operations
• JWT tokens include role information
• Unauthorized access returns 403 Forbidden

Data Validation

All admin operations validate:

• Required fields are present
• Data types are correct
• Unique constraints (SKU, category names)
• Referential integrity (categories exist)

Never share admin credentials. Use individual admin accounts with proper role assignments for accountability.

API Reference Summary

Product Endpoints (Admin)

• POST /api/productos - Create product
• PUT /api/productos/sku/{sku} - Update product by SKU
• DELETE /api/productos/{id} - Delete product

Category Endpoints (Admin)

• POST /api/categorias - Create category
• PUT /api/categorias/{nombre} - Update category
• DELETE /api/categorias/{nombre} - Delete category

Order Endpoints (Admin)

• GET /api/pedidos - List all orders
• GET /api/pedidos/estado/{estado} - Filter by status
• PUT /api/pedidos/{id} - Update order
• DELETE /api/pedidos/{id} - Delete order
• POST /api/pedidos/{id}/detalles - Add order detail
• DELETE /api/detalles/{id} - Remove order detail
• PUT /api/detalles/{id}/cantidad - Update detail quantity

Troubleshooting

Cannot Access Admin Features

Problem: Admin options not visible

Solution: Verify your account has rol: ADMIN. Contact a system administrator to update your role.

Product Creation Fails

Problem: Cannot create new product

Common Causes:

• Duplicate SKU (must be unique)
• Missing required fields
• Invalid category reference
• Malformed image URL

Order Status Won’t Update

Problem: Order status update fails

Solutions:

• Verify order exists
• Check status is valid enum value
• Ensure you have admin permissions

Related Guides

• Shopping Guide - Customer shopping experience
• Cart and Checkout - Checkout process that creates orders
• Order Management - Customer order viewing